home *** CD-ROM | disk | FTP | other *** search
/ IRIX Base Documentation 2002 November / SGI IRIX Base Documentation 2002 November.iso / usr / share / catman / u_man / cat1 / licensemanager.z / licensemanager
Encoding:
Text File  |  2002-10-03  |  40.3 KB  |  727 lines

  1.  
  2.  
  3.  
  4. LLLLiiiicccceeeennnnsssseeeeMMMMaaaannnnaaaaggggeeeerrrr((((1111MMMM))))                                          LLLLiiiicccceeeennnnsssseeeeMMMMaaaannnnaaaaggggeeeerrrr((((1111MMMM))))
  5.  
  6.  
  7.  
  8. NNNNAAAAMMMMEEEE
  9.      LicenseManager - view and manage FLEXlm and NetLS software licenses
  10.  
  11. SSSSYYYYNNNNOOOOPPPPSSSSIIIISSSS
  12.      ////uuuussssrrrr////eeeettttcccc////LLLLiiiicccceeeennnnsssseeeeMMMMaaaannnnaaaaggggeeeerrrr [ ----vvvveeeennnnddddoooorrrr { ssssggggiiii | aaaawwww } ]
  13.  
  14.      ////uuuussssrrrr////eeeettttcccc////LLLLiiiicccceeeennnnsssseeeeMMMMaaaannnnaaaaggggeeeerrrr [ ----vvvveeeennnnddddoooorrrr { ssssggggiiii | aaaawwww } ] _n_a_m_e_s ...
  15.  
  16.      ////uuuussssrrrr////eeeettttcccc////LLLLiiiicccceeeennnnsssseeeeMMMMaaaannnnaaaaggggeeeerrrr ----iiiinnnnssssttttaaaallllllll { fffflllleeeexxxxllllmmmm____nnnnooooddddeeeelllloooocccckkkk |
  17.                                         fffflllleeeexxxxllllmmmm____ffffllllooooaaaattttiiiinnnngggg |
  18.                                         fffflllleeeexxxxllllmmmm____iiiinnnnccccrrrreeeemmmmeeeennnntttt |
  19.                                         fffflllleeeexxxxllllmmmm____nnnnooooddddeeeelllloooocccckkkk____ppppaaaacccckkkkaaaaggggeeee |
  20.                                         fffflllleeeexxxxllllmmmm____ffffllllooooaaaattttiiiinnnngggg____ppppaaaacccckkkkaaaaggggeeee |
  21.                                         fffflllleeeexxxxllllmmmm____iiiinnnnccccrrrreeeemmmmeeeennnntttt____ppppaaaacccckkkkaaaaggggeeee |
  22.                                         nnnneeeettttllllssss }
  23.  
  24.      ////uuuussssrrrr////eeeettttcccc////LLLLiiiicccceeeennnnsssseeeeMMMMaaaannnnaaaaggggeeeerrrr ----VVVV
  25.  
  26.  
  27. DDDDEEEESSSSCCCCRRRRIIIIPPPPTTTTIIIIOOOONNNN
  28.      When executed without file arguments, LLLLiiiicccceeeennnnsssseeee MMMMaaaannnnaaaaggggeeeerrrr displays the MMMMaaaaiiiinnnn
  29.      WWWWiiiinnnnddddoooowwww, which provides a complete graphical interface for viewing,
  30.      installing, upgrading, and removing FLEXlm and NetLS software licenses.
  31.  
  32.      The optional argument ----vvvveeeennnnddddoooorrrr is used to specify the vvvveeeennnnddddoooorrrr mmmmooooddddeeee, which
  33.      customizes the License Manager interface for a specific vendor. The
  34.      vendor mode determines the default values of license entry fields, the
  35.      location of the license files, and the location of licensing server
  36.      startup scripts.  The values that can follow ----vvvveeeennnnddddoooorrrr are ssssggggiiii and aaaawwww.  ssssggggiiii
  37.      specifies the vendor mode for licenses from Silicon Graphics and from
  38.      other vendors.  aaaawwww specifies the vendor mode for licenses from Alias |
  39.      Wavefront.  The default value when vendor mode is not specified is ssssggggiiii.
  40.  
  41.      When LLLLiiiicccceeeennnnsssseeee MMMMaaaannnnaaaaggggeeeerrrr is run with file arguments _n_a_m_e_s ..., License
  42.      Manager runs in automatic license installation mode.  Each name specified
  43.      in _n_a_m_e_s ... is the pathname of a LLLLiiiicccceeeennnnsssseeee IIIInnnnssssttttaaaallllllllaaaattttiiiioooonnnn FFFFiiiilllleeee.  The format
  44.      of these files are documented below.  When running in this mode, licenses
  45.      in these files are automatically installed on the system, and a popup
  46.      dialog displaying the installation status of all licenses in these files
  47.      are displayed. NNNNOOOOTTTTEEEE:::: This mode is used to support the automatic
  48.      installation of software licenses over the World Wide Web or via E-mail
  49.      attachment.
  50.  
  51.      When LLLLiiiicccceeeennnnsssseeee MMMMaaaannnnaaaaggggeeeerrrr is run with the ----iiiinnnnssssttttaaaallllllll argument, the License
  52.      Manager graphical interface is invoked with the license installation
  53.      dialog already displayed.  The type of dialog displayed is determined by
  54.      the type of license being installed, which is specified by the second
  55.      argument:  fffflllleeeexxxxllllmmmm____nnnnooooddddeeeelllloooocccckkkk, fffflllleeeexxxxllllmmmm____ffffllllooooaaaattttiiiinnnngggg, fffflllleeeexxxxllllmmmm____iiiinnnnccccrrrreeeemmmmeeeennnntttt,
  56.      fffflllleeeexxxxllllmmmm____nnnnooooddddeeeelllloooocccckkkk____ppppaaaacccckkkkaaaaggggeeee, fffflllleeeexxxxllllmmmm____ffffllllooooaaaattttiiiinnnngggg____ppppaaaacccckkkkaaaaggggeeee,
  57.      fffflllleeeexxxxllllmmmm____iiiinnnnccccrrrreeeemmmmeeeennnntttt____ppppaaaacccckkkkaaaaggggeeee, or nnnneeeettttllllssss. NNNNOOOOTTTTEEEE:::: This mode is used to support
  58.      the license installation tasks found in the SSSSyyyysssstttteeeemmmm MMMMaaaannnnaaaaggggeeeerrrr and is not
  59.      intended to be used directly by the user.
  60.  
  61.  
  62.  
  63.                                                                         PPPPaaaaggggeeee 1111
  64.  
  65.  
  66.  
  67.  
  68.  
  69.  
  70. LLLLiiiicccceeeennnnsssseeeeMMMMaaaannnnaaaaggggeeeerrrr((((1111MMMM))))                                          LLLLiiiicccceeeennnnsssseeeeMMMMaaaannnnaaaaggggeeeerrrr((((1111MMMM))))
  71.  
  72.  
  73.  
  74.      When run with the ----VVVV option, License Manager just prints out its version
  75.      string.
  76.  
  77.  
  78. LLLLIIIICCCCEEEENNNNSSSSEEEE LLLLIIIISSSSTTTT
  79.      The License Manager Main Window displays a list of installed licenses.
  80.      FFFFLLLLEEEEXXXXllllmmmm licenses that are installed using this tool or manually entered
  81.      into a license file using a text editor are always displayed in this
  82.      list.  NNNNeeeettttLLLLSSSS licenses that are installed using this tool or manually
  83.      entered into a license file using a text editor in a format understood by
  84.      this tool will also be recognized and displayed in this list. Licenses
  85.      that are manually entered into a NetLS license file in a format not
  86.      understood by this tool are retained in the file, but cannot be viewed or
  87.      managed using LLLLiiiicccceeeennnnsssseeee MMMMaaaannnnaaaaggggeeeerrrr.
  88.  
  89. LLLLIIIICCCCEEEENNNNSSSSEEEE SSSSEEEERRRRVVVVEEEERRRR MMMMAAAANNNNAAAAGGGGEEEEMMMMEEEENNNNTTTT
  90.      When exiting License Manager, if any FFFFLLLLEEEEXXXXllllmmmm ffffllllooooaaaattttiiiinnnngggg licenses were
  91.      installed during the session, License Manager will prompt the user to
  92.      determine if it should update the license server llllmmmmggggrrrrdddd((((1111)))) to use the new
  93.      licenses.  If the user clicks OOOOKKKK, License Manager will start the
  94.      licensing server if it is not running, or ask the license server to
  95.      reread its license file using llllmmmmrrrreeeerrrreeeeaaaadddd((((1111)))).
  96.  
  97.  
  98. CCCCHHHHEEEECCCCKKKKIIIINNNNGGGG LLLLIIIICCCCEEEENNNNSSSSEEEE SSSSTTTTAAAATTTTUUUUSSSS
  99.      This tool is able to decode licenses issued by Silicon Graphics to check
  100.      for entry errors, but it is not able to check licenses issued by other
  101.      vendors.
  102.  
  103.  
  104. MMMMAAAAIIIINNNN WWWWIIIINNNNDDDDOOOOWWWW
  105.      The Main Window displays the list of products and licenses installed in
  106.      the license files that are recognized by this tool.  For each license,
  107.      the list displays the _P_r_o_d_u_c_t _N_a_m_e, _E_x_p_i_r_a_t_i_o_n _D_a_t_e, and _L_i_c_e_n_s_e _T_y_p_e.
  108.  
  109.      _O_p_e_r_a_t_i_o_n_s:
  110.  
  111.      IIIInnnnssssttttaaaallllllll............
  112.           Display the Install License Dialog Window, which is used to install
  113.           a license for a new product or a new version of a product.
  114.  
  115.      UUUUppppddddaaaatttteeee............
  116.           Display the Update License Dialog Window, which is used to enter a
  117.           license password for a product that already appears in the Main
  118.           Window. The user can use this operation to convert a temporary
  119.           license into a permanent one.
  120.  
  121.      RRRReeeemmmmoooovvvveeee............
  122.           Remove the license selected in the Main Window.
  123.  
  124.  
  125.  
  126.  
  127.  
  128.  
  129.                                                                         PPPPaaaaggggeeee 2222
  130.  
  131.  
  132.  
  133.  
  134.  
  135.  
  136. LLLLiiiicccceeeennnnsssseeeeMMMMaaaannnnaaaaggggeeeerrrr((((1111MMMM))))                                          LLLLiiiicccceeeennnnsssseeeeMMMMaaaannnnaaaaggggeeeerrrr((((1111MMMM))))
  137.  
  138.  
  139.  
  140.      GGGGeeeetttt IIIInnnnffffoooo............
  141.           Display the Get Info Dialog Window, which shows information about
  142.           the license selected in the Main Window.
  143.  
  144.      OOOOppppttttiiiioooonnnnssss ............
  145.           Displays the Options Dialog Window, which allows the user to switch
  146.           between the Silicon Graphics and Alias | Wavefront vendor mode.
  147.  
  148.      CCCClllloooosssseeee
  149.           Close the Main Window and exit License Manager.
  150.  
  151.      HHHHeeeellllpppp Display help information for License Manager.
  152.  
  153.  
  154. UUUUPPPPDDDDAAAATTTTEEEE LLLLIIIICCCCEEEENNNNSSSSEEEE DDDDIIIIAAAALLLLOOOOGGGG WWWWIIIINNNNDDDDOOOOWWWW
  155.      The Update License Dialog Window is used to enter a new license password
  156.      for a product that already appears in the Main Window.  It can be used to
  157.      update a temporary license into a permanent license.
  158.  
  159.      If a NetLS license is selected, this window displays the _L_i_c_e_n_s_e _P_a_s_s_w_o_r_d
  160.      and _E_x_p_i_r_a_t_i_o_n _D_a_t_e fields.
  161.  
  162.      If a FLEXlm license is selected, this window displays the the _P_a_s_s_w_o_r_d,
  163.      _M_i_s_c_e_l_l_a_n_e_o_u_s, _E_x_p_i_r_a_t_i_o_n, and _H_o_s_t _I_D fields.
  164.  
  165.      _O_p_e_r_a_t_i_o_n_s:
  166.  
  167.      AAAAppppppppllllyyyy
  168.           Update the license with the new license password.
  169.  
  170.      CCCCaaaannnncccceeeellll
  171.           Close the Update License Dialog Window.
  172.  
  173.  
  174. GGGGEEEETTTT IIIINNNNFFFFOOOO DDDDIIIIAAAALLLLOOOOGGGG WWWWIIIINNNNDDDDOOOOWWWW
  175.      The Get Info Dialog Window shows information about the selected license.
  176.      The fields displayed depend on the type of license that was selected in
  177.      the Main Window.  The status of the license is always displayed at the
  178.      bottom.
  179.  
  180.      _O_p_e_r_a_t_i_o_n_s:
  181.  
  182.      CCCClllloooosssseeee
  183.           Close the Get Info Dialog Window.
  184.  
  185.  
  186. IIIINNNNSSSSTTTTAAAALLLLLLLL LLLLIIIICCCCEEEENNNNSSSSEEEE DDDDIIIIAAAALLLLOOOOGGGG WWWWIIIINNNNDDDDOOOOWWWW
  187.      The Install License Dialog Window is used to add a license for a new
  188.      product or version that does not already appear in the Main Window
  189.      license list.
  190.  
  191.  
  192.  
  193.  
  194.  
  195.                                                                         PPPPaaaaggggeeee 3333
  196.  
  197.  
  198.  
  199.  
  200.  
  201.  
  202. LLLLiiiicccceeeennnnsssseeeeMMMMaaaannnnaaaaggggeeeerrrr((((1111MMMM))))                                          LLLLiiiicccceeeennnnsssseeeeMMMMaaaannnnaaaaggggeeeerrrr((((1111MMMM))))
  203.  
  204.  
  205.  
  206.      The user chooses the type of license to install and clicks OOOOKKKK to display
  207.      the License Entry Dialog Window.  Click CCCCaaaannnncccceeeellll to close the dialog
  208.      without installing a license.
  209.  
  210.  
  211. LLLLIIIICCCCEEEENNNNSSSSEEEE EEEENNNNTTTTRRRRYYYY DDDDIIIIAAAALLLLOOOOGGGG
  212.      The License Entry Dialog displays the license fields for the type of
  213.      license being installed.  These fields are documented below.  Enter the
  214.      appropriate license information and click OOOOKKKK to install the license.
  215.  
  216.      At the bottom of the dialog, the default installation location for the
  217.      license is displayed.
  218.  
  219.      _O_p_e_r_a_t_i_o_n_s:
  220.  
  221.      BBBBrrrroooowwwwsssseeee ............
  222.           Displays a dialog used for overriding the default license
  223.           installation location
  224.  
  225.      OOOOKKKK   Install the license entered.
  226.  
  227.      CCCCaaaannnncccceeeellll
  228.           Close the Install License Dialog Window.
  229.  
  230.      _E_n_t_r_y _F_i_e_l_d_s:
  231.  
  232.      The following entry fields will appear in some or all of the License
  233.      Entry Dialogs. See the _F_L_E_X_l_m _E_n_d _U_s_e_r _M_a_n_u_a_l for more information about
  234.      FLEXlm fields.
  235.  
  236.  
  237.      AAAAnnnnnnnnoooottttaaaattttiiiioooonnnn
  238.           This is the optional annotation for a NetLS nodelock license.
  239.  
  240.      DDDDaaaaeeeemmmmoooonnnn
  241.           This is the name of the vendor daemon for a FLEXlm Floating license.
  242.  
  243.      DDDDaaaaeeeemmmmoooonnnn PPPPaaaatttthhhh
  244.           This is the pathname of the vendor daemon for a FLEXlm Floating
  245.           license.
  246.  
  247.      EEEExxxxppppiiiirrrraaaattttiiiioooonnnn
  248.           The license expiration date.
  249.  
  250.      FFFFeeeeaaaattttuuuurrrreeee
  251.           The feature name for a FLEXlm license.
  252.  
  253.      IIIInnnnccccrrrreeeemmmmeeeennnntttt
  254.           This is the feature name for an INCREMENT license.
  255.  
  256.  
  257.  
  258.  
  259.  
  260.  
  261.                                                                         PPPPaaaaggggeeee 4444
  262.  
  263.  
  264.  
  265.  
  266.  
  267.  
  268. LLLLiiiicccceeeennnnsssseeeeMMMMaaaannnnaaaaggggeeeerrrr((((1111MMMM))))                                          LLLLiiiicccceeeennnnsssseeeeMMMMaaaannnnaaaaggggeeeerrrr((((1111MMMM))))
  269.  
  270.  
  271.  
  272.      LLLLiiiicccceeeennnnsssseeee VVVVeeeerrrrssssiiiioooonnnn
  273.           The license version.
  274.  
  275.      MMMMiiiisssscccceeeellllllllaaaannnneeeeoooouuuussss
  276.           This field is used to enter other FLEXlm optional license arguments.
  277.           Values entered in this field will take the form _a_t_t_r_i_b_u_t_e====_v_a_l_u_e
  278.           separated by spaces. For example, ddddiiiisssstttt____iiiinnnnffffoooo====nnnnoooorrrreeeeppppllllaaaacccceeee
  279.           uuuusssseeeerrrr____iiiinnnnffffoooo====ddddeeeemmmmoooo.
  280.  
  281.      PPPPaaaacccckkkkaaaaggggeeee KKKKeeeeyyyy
  282.           This is the Package license key, which enables a package specified
  283.           by FFFFeeeeaaaattttuuuurrrreeee.
  284.  
  285.      PPPPaaaacccckkkkaaaaggggeeee LLLLiiiisssstttt
  286.           This is the list of products for the package specified by FFFFeeeeaaaattttuuuurrrreeee.
  287.  
  288.      PPPPaaaacccckkkkaaaaggggeeee OOOOppppttttiiiioooonnnnssss
  289.           This specifies the options for the package specified by FFFFeeeeaaaattttuuuurrrreeee.
  290.  
  291.      PPPPaaaasssssssswwwwoooorrrrdddd
  292.           The license password.
  293.  
  294.      PPPPoooorrrrtttt NNNNuuuummmmbbbbeeeerrrr
  295.           This is the port number used by lmgrd(1M). It is specified the
  296.           FLEXlm license SERVER line.
  297.  
  298.      PPPPrrrroooodddduuuucccctttt NNNNaaaammmmeeee
  299.           The long product name for a license. For FLEXlm licenses, this value
  300.           is stored in the optional field vvvveeeennnnddddoooorrrr____iiiinnnnffffoooo.
  301.  
  302.      SSSSeeeerrrrvvvveeeerrrr HHHHoooosssstttt
  303.           The name of the license server host.
  304.  
  305.      SSSSeeeerrrrvvvveeeerrrr HHHHoooosssstttt IIIIDDDD
  306.           The host ID for the license server host. For licenses from SGI and
  307.           other vendors, this value is generated by using the command ssssyyyyssssiiiinnnnffffoooo
  308.           ----ssss. For licenses from Alias | Wavefront, this value is generated by
  309.           using the command llllmmmmhhhhoooossssttttiiiidddd.
  310.  
  311.      VVVVeeeennnnddddoooorrrr NNNNaaaammmmeeee
  312.           The name of the license issuer.
  313.  
  314.      VVVVeeeennnnddddoooorrrr IIIIDDDD
  315.           This is the Vendor ID for a NetLS nodelock license.
  316.  
  317.      VVVVeeeennnnddddoooorrrr SSSSttttrrrriiiinnnngggg
  318.           The vendor string for a FLEXlm license.
  319.  
  320.  
  321.  
  322.  
  323.  
  324.  
  325.  
  326.  
  327.                                                                         PPPPaaaaggggeeee 5555
  328.  
  329.  
  330.  
  331.  
  332.  
  333.  
  334. LLLLiiiicccceeeennnnsssseeeeMMMMaaaannnnaaaaggggeeeerrrr((((1111MMMM))))                                          LLLLiiiicccceeeennnnsssseeeeMMMMaaaannnnaaaaggggeeeerrrr((((1111MMMM))))
  335.  
  336.  
  337.  
  338. FFFFIIIILLLLEEEESSSS
  339.      ////vvvvaaaarrrr////nnnneeeettttllllssss////nnnnooooddddeeeelllloooocccckkkk
  340.  
  341.           This file contains the NetLS nodelock licenses.  Properly formatted
  342.           licenses in this file can be read in and displayed by License
  343.           Manager. Licenses installed using License Manager will always be
  344.           written to the file in this format.  Licenses that are not formatted
  345.           for License Manager are retained in the file, but cannot be viewed
  346.           using this tool.
  347.  
  348.           A properly formatted license will have the following form:
  349.  
  350.           ####::::#### "_V_e_n_d_o_r_N_a_m_e" "_P_r_o_d_u_c_t_N_a_m_e" "_V_e_r_s_i_o_n" "_E_x_p_i_r_a_t_i_o_n" [_P_r_o_d_u_c_t_I_D]
  351.           _V_e_n_d_o_r_I_D [ _P_a_s_s_w_o_r_d [ "_A_n_n_o_t_a_t_i_o_n" ]]
  352.  
  353.  
  354.      ////eeeettttcccc////nnnnooooddddeeeelllloooocccckkkk
  355.  
  356.           This file also contains NetLS nodelock licenses and is the location
  357.           used by some NetLS licensed applications which must get their
  358.           licenses from the root partition.
  359.  
  360.  
  361.      ////vvvvaaaarrrr////fffflllleeeexxxxllllmmmm////lllliiiicccceeeennnnsssseeee....ddddaaaatttt
  362.  
  363.           This file is the standard installation location for FLEXlm nodelock
  364.           licenses used by SGI applications.  License Manager is able to read
  365.           in all FLEXlm licenses contained in this file.
  366.  
  367.  
  368.      ////vvvvaaaarrrr////fffflllleeeexxxxllllmmmm////aaaawwww....ddddaaaatttt
  369.  
  370.           This file is the standard installation location for FLEXlm nodelock
  371.           licenses used by Alias | Wavefront applications.  Licenses are
  372.           installed in this file when the vendor mode is specified as aaaawwww.
  373.  
  374.  
  375.      ////vvvvaaaarrrr////fffflllleeeexxxxllllmmmm////lllliiiicccceeeennnnsssseeee_____H_o_s_t_N_a_m_e....ddddaaaatttt
  376.  
  377.           On the license server _H_o_s_t_N_a_m_e, this file is the standard
  378.           installation location for FLEXlm floating licenses for that host.
  379.           Users on client systems who want to use licenses on this server
  380.           should copy this file to their systems using the same pathname if
  381.           they do not intend to use LLLLMMMM____LLLLIIIICCCCEEEENNNNSSSSEEEE____FFFFIIIILLLLEEEE to specify the
  382.           _p_o_r_t@@@@_h_o_s_t_n_a_m_e of the license server.  See the _F_L_E_X_l_m _E_n_d _U_s_e_r _M_a_n_u_a_l
  383.           for more information about using port@hostname.
  384.  
  385.  
  386.      ////vvvvaaaarrrr////fffflllleeeexxxxllllmmmm////aaaawwww_____H_o_s_t_N_a_m_e....ddddaaaatttt
  387.           On the license server _H_o_s_t_N_a_m_e, this file is the standard
  388.           installation location for FLEXlm floating licenses for Alias |
  389.           Wavefront applications.  Licenses are installed in this file when
  390.  
  391.  
  392.  
  393.                                                                         PPPPaaaaggggeeee 6666
  394.  
  395.  
  396.  
  397.  
  398.  
  399.  
  400. LLLLiiiicccceeeennnnsssseeeeMMMMaaaannnnaaaaggggeeeerrrr((((1111MMMM))))                                          LLLLiiiicccceeeennnnsssseeeeMMMMaaaannnnaaaaggggeeeerrrr((((1111MMMM))))
  401.  
  402.  
  403.  
  404.           the vendor mode is specified as aaaawwww.  Users on client systems who
  405.           want to use licenses on this server should copy this file to their
  406.           systems using the same pathname if they do not intend to use
  407.           LLLLMMMM____LLLLIIIICCCCEEEENNNNSSSSEEEE____FFFFIIIILLLLEEEE to specify the _p_o_r_t@@@@_h_o_s_t_n_a_m_e of the license server.
  408.  
  409.  
  410.      ////vvvvaaaarrrr////fffflllleeeexxxxllllmmmm////lllliiiicccceeeennnnsssseeeeffffiiiilllleeee....ddddbbbb
  411.  
  412.           This file specifies the LLLLiiiicccceeeennnnsssseeee FFFFiiiilllleeee DDDDaaaattttaaaabbbbaaaasssseeee, which determines the
  413.           list of FLEXlm license files searched by a licensed Silicon Graphics
  414.           application.  License Manager uses this database file to determine
  415.           the list of license files to read when displaying the installed
  416.           licenses.
  417.  
  418.           The format of a license file database is one file or directory per
  419.           line.  Comments are indicated by a pound sign '#' in the first
  420.           column of the line.  Blank lines are ignored.  Trailing and/or
  421.           leading whitespace is not allowed on a line.
  422.  
  423.           Any directory listed in the file is searched for filenames matching
  424.           "*._d_a_t".  Any subdirectory is also searched (recursively).
  425.  
  426.           License Manager also uses this file to determine which files can be
  427.           updated when installing a software license.  If the installation
  428.           location is not specified in this file, the user is prompted, and
  429.           the license is installed only if the user decides to install it,
  430.           automatically updating this database file with the new license file
  431.           location.
  432.  
  433.  
  434.      ////eeeettttcccc////ccccoooonnnnffffiiiigggg////llllmmmmggggrrrrdddd....ooooppppttttiiiioooonnnnssss
  435.  
  436.           This file specifies the options to use when ////eeeettttcccc////iiiinnnniiiitttt....dddd////FFFFLLLLEEEEXXXXllllmmmm is
  437.           used to start the _F_L_E_X_l_m _L_i_c_e_n_s_e _D_a_e_m_o_n llllmmmmggggrrrrdddd((((1111)))).  Normally, this
  438.           file is used to specify the location of the file which contains the
  439.           floating licenses for this license server.
  440.  
  441.           If this file contains the default value ----cccc ////vvvvaaaarrrr////fffflllleeeexxxxllllmmmm////lllliiiicccceeeennnnsssseeee....ddddaaaatttt,
  442.           License Manager will update this file to point to the correct
  443.           location whenever a floating license is installed.
  444.  
  445.  
  446.      LLLLiiiicccceeeennnnsssseeee IIIInnnnssssttttaaaallllllllaaaattttiiiioooonnnn FFFFiiiilllleeeessss
  447.  
  448.           License Installation Files are used to support the installation of
  449.           software licenses using the World Wide Web or E-mail attachment.
  450.           When License Manager is run with one of these files as an argument,
  451.           the licenses contained in this file are installed into the
  452.           appropriate license files.
  453.  
  454.           Each license installation file contains one or more license
  455.           installation blocks, and each block can install either NetLS or
  456.  
  457.  
  458.  
  459.                                                                         PPPPaaaaggggeeee 7777
  460.  
  461.  
  462.  
  463.  
  464.  
  465.  
  466. LLLLiiiicccceeeennnnsssseeeeMMMMaaaannnnaaaaggggeeeerrrr((((1111MMMM))))                                          LLLLiiiicccceeeennnnsssseeeeMMMMaaaannnnaaaaggggeeeerrrr((((1111MMMM))))
  467.  
  468.  
  469.  
  470.           FLEXlm licenses.
  471.  
  472.  
  473.      _N_e_t_L_S _L_i_c_e_n_s_e _I_n_s_t_a_l_l_a_t_i_o_n _B_l_o_c_k
  474.  
  475.           A NetLS license installation block will consist of a header and one
  476.           or more NetLS licenses.  Note that the location of each line in the
  477.           block determines the semantics of the data.
  478.  
  479.           The header has the following format:
  480.  
  481.           ############ NNNNeeeettttLLLLSSSS NNNNooooddddeeeelllloooocccckkkkeeeedddd LLLLiiiicccceeeennnnsssseeee FFFFiiiilllleeee NNNNLLLLSSSSNNNNLLLLFFFF 1111....0000
  482.           _S_y_s_t_e_m__I_D
  483.           _H_o_s_t__N_a_m_e
  484.  
  485.           If the license can be installed on any host, the _S_y_s_t_e_m _I_D should be
  486.           0000 and the _H_o_s_t__N_a_m_e should be AAAAnnnnyyyy.  These two fields are used by
  487.           License Manager to check if the license block should be installed on
  488.           a host.  If not, the license block is written to a LLLLiiiicccceeeennnnsssseeee BBBBlllloooocccckkkk
  489.           SSSSaaaavvvveeee FFFFiiiilllleeee located at ////vvvvaaaarrrr////fffflllleeeexxxxllllmmmm////ssssaaaavvvveeee////lllliiiicccceeeennnnsssseeee____iiiinnnnssssttttaaaallllllll...._H_o_s_t__N_a_m_e
  490.           where _H_o_s_t__N_a_m_e  is the name of the host to which this license block
  491.           should be installed.
  492.  
  493.           Each license will consists of the following lines:
  494.  
  495.           LLLLIIIICCCCEEEENNNNSSSSEEEE
  496.           _V_e_n_d_o_r__N_a_m_e
  497.           _V_e_n_d_o_r__P_a_s_s_w_o_r_d
  498.           _V_e_n_d_o_r__I_D
  499.           _P_r_o_d_u_c_t__N_a_m_e
  500.           _P_r_o_d_u_c_t__I_D
  501.           _P_r_o_d_u_c_t__V_e_r_s_i_o_n
  502.           _P_r_o_d_u_c_t__P_a_s_s_w_o_r_d
  503.           _A_n_n_o_t_a_t_i_o_n
  504.  
  505.           If there is no license annotation, then a blank line should be used
  506.           as the annotation.
  507.  
  508.  
  509.  
  510.      _F_L_E_X_l_m _L_i_c_e_n_s_e _I_n_s_t_a_l_l_a_t_i_o_n _B_l_o_c_k
  511.  
  512.           A FLEXlm license installation block consist of a header and one or
  513.           more FLEXlm nodelock or floating licenses.  The license lines in
  514.           this block have the same format as any FLEXlm license file.
  515.  
  516.           The format of the block header file consists of the mandatory header
  517.           line and optional installation directive lines for specifying the
  518.           license installation location, the installation host, and the
  519.           installation control argument.
  520.  
  521.           The FFFFiiiilllleeeennnnaaaammmmeeee directive is used to specify the installation location
  522.  
  523.  
  524.  
  525.                                                                         PPPPaaaaggggeeee 8888
  526.  
  527.  
  528.  
  529.  
  530.  
  531.  
  532. LLLLiiiicccceeeennnnsssseeeeMMMMaaaannnnaaaaggggeeeerrrr((((1111MMMM))))                                          LLLLiiiicccceeeennnnsssseeeeMMMMaaaannnnaaaaggggeeeerrrr((((1111MMMM))))
  533.  
  534.  
  535.  
  536.           of licenses in the block.  If this directive is omitted, the
  537.           licenses are installed at the default locations for FLEXlm licenses.
  538.           See the section on FFFFIIIILLLLEEEESSSS above.
  539.  
  540.           The HHHHoooosssstttt directive is used to specify the name of the installation
  541.           host.  License blocks that can be installed on any host can omit
  542.           this line or specify the hostname AAAAnnnnyyyy.  If a license block cannot be
  543.           installed because the host name does not match, the block is written
  544.           to a LLLLiiiicccceeeennnnsssseeee BBBBlllloooocccckkkk SSSSaaaavvvveeee FFFFiiiilllleeee located at
  545.           ////vvvvaaaarrrr////fffflllleeeexxxxllllmmmm////ssssaaaavvvveeee////lllliiiicccceeeennnnsssseeee____iiiinnnnssssttttaaaallllllll...._H_o_s_t__N_a_m_e where _H_o_s_t__N_a_m_e  is the
  546.           name of the host to which this license block should be installed.
  547.  
  548.           The CCCCoooonnnnttttrrrroooollll directive is used to specify the installation control
  549.           argument.  Currently, one of two options can be specified. The first
  550.           is nnnnooooRRRReeeeppppllllaaaacccceeee, which causes the licenses in the block to be installed
  551.           without replacing any existing licenses.  The second is
  552.           ssssttttrrrriiiiccccttttRRRReeeeppppllllaaaacccceeee, which behaves just like the normal license
  553.           replacement policy if the feature name and version match exactly --
  554.           otherwise it behaves just like the nnnnooooRRRReeeeppppllllaaaacccceeee directive.
  555.  
  556.      ############ FFFFlllleeeexxxxLLLLMMMM LLLLiiiicccceeeennnnsssseeee FFFFiiiilllleeee FFFFLLLLMMMMLLLLFFFF 1111....0000
  557.      ############ FFFFiiiilllleeeennnnaaaammmmeeee:::: _L_i_c_e_n_s_e__F_i_l_e
  558.      ############ HHHHoooosssstttt:::: _H_o_s_t__N_a_m_e
  559.      ############ CCCCoooonnnnttttrrrroooollll:::: nnnnooooRRRReeeeppppllllaaaacccceeee
  560.  
  561.  
  562.           Note that because each license installation block can install to
  563.           only one file, and because SGI recommends that FLEXlm nodelock
  564.           licenses be kept in files separate from files holding floating
  565.           licenses, each license block should contain either nodelock licenses
  566.           for one host or concurrent licenses for one host.  This limitation
  567.           applies only to a license installation block, and not to the license
  568.           installation file.
  569.  
  570.  
  571.      _L_i_c_e_n_s_e _B_l_o_c_k _S_a_v_e _F_i_l_e_s
  572.  
  573.           These files contain the license installation blocks that could not
  574.           be installed by License Manager because the hostname did not match
  575.           when License Manager was executed with a License Installation File
  576.           argument.  These files can be transferred to their appropriate host
  577.           and the licenses contained in them can be installed by executing
  578.           License Manager on these files.
  579.  
  580.           The files containing these saved license installation blocks are
  581.           located at ////vvvvaaaarrrr////fffflllleeeexxxxllllmmmm////ssssaaaavvvveeee////lllliiiicccceeeennnnsssseeee____iiiinnnnssssttttaaaallllllll...._H_o_s_t__N_a_m_e.
  582.  
  583.  
  584. EEEENNNNVVVVIIIIRRRROOOONNNNMMMMEEEENNNNTTTT
  585.      LLLLMMMM____LLLLIIIICCCCEEEENNNNSSSSEEEE____FFFFIIIILLLLEEEE
  586.           If set, specifies the name of one or more FLEXlm license files.
  587.           Multiple files can be specified by separating them with a colon (::::).
  588.  
  589.  
  590.  
  591.                                                                         PPPPaaaaggggeeee 9999
  592.  
  593.  
  594.  
  595.  
  596.  
  597.  
  598. LLLLiiiicccceeeennnnsssseeeeMMMMaaaannnnaaaaggggeeeerrrr((((1111MMMM))))                                          LLLLiiiicccceeeennnnsssseeeeMMMMaaaannnnaaaaggggeeeerrrr((((1111MMMM))))
  599.  
  600.  
  601.  
  602.           The value of this variable overrides the list of files specified by
  603.           the LLLLiiiicccceeeennnnsssseeee FFFFiiiilllleeee DDDDaaaattttaaaabbbbaaaasssseeee.
  604.  
  605.  
  606.      LLLLMMMM____LLLLIIIICCCCEEEENNNNSSSSEEEE____DDDDBBBB
  607.           If set, specifies the name of the license file database.  A license
  608.           file database is a file which contains a list of one or more FLEXlm
  609.           license files and/or directories containing FLEXlm license files.
  610.  
  611.           If _L_M__L_I_C_E_N_S_E__D_B is not defined, the default license file database,
  612.           /_v_a_r/_f_l_e_x_l_m/_l_i_c_e_n_s_e_f_i_l_e._d_b, is used.
  613.  
  614.  
  615.      LLLLMMMM____VVVVEEEENNNNDDDDOOOORRRR____MMMMOOOODDDDEEEE
  616.           If set, the value of this variable is treated like the -_v_e_n_d_o_r
  617.           argument documented above.  The value of this variable is overrident
  618.           if -_v_e_n_d_o_r is specified in the command line.
  619.  
  620.  
  621.      LLLLIIIICCCCEEEENNNNSSSSEEEEMMMMGGGGRRRR____DDDDEEEEBBBBUUUUGGGG
  622.           When set, License Manager runs in _d_e_b_u_g mode, and prints assorted
  623.           output to standard out during license installation.
  624.  
  625.  
  626.      LLLLIIIICCCCEEEENNNNSSSSEEEEMMMMGGGGRRRR____FFFFIIIILLLLEEEE____RRRROOOOOOOOTTTT
  627.           Determines the root, which is prepended to all pathnames of
  628.           permanent files that are written by License Manager.  If this
  629.           variable is not set, all file names are assumed to be relative to
  630.           the root file system /.
  631.  
  632.  
  633.      LLLLIIIICCCCEEEENNNNSSSSEEEEMMMMGGGGRRRR____NNNNOOOO____GGGGUUUUIIII
  634.           Specifies that License Manager run without a graphical user
  635.           interface.  This mode has an effect when running License Manager in
  636.           the automatic license installation mode.  All output messages are
  637.           printed to stdout and all prompts default to OOOOKKKK.
  638.  
  639.  
  640. DDDDEEEEFFFFAAAAUUUULLLLTTTT LLLLIIIICCCCEEEENNNNSSSSEEEE FFFFIIIILLLLEEEE
  641.      If no license files have been defined by either the LLLLMMMM____LLLLIIIICCCCEEEENNNNSSSSEEEE____FFFFIIIILLLLEEEE or by
  642.      the LLLLiiiicccceeeennnnsssseeee FFFFiiiilllleeee DDDDaaaattttaaaabbbbaaaasssseeee, the default FLEXlm license file is
  643.      ////vvvvaaaarrrr////fffflllleeeexxxxllllmmmm////lllliiiicccceeeennnnsssseeee....ddddaaaatttt when the vendor mode is unspecified or specified
  644.      as ssssggggiiii, and /_v_a_r/_f_l_e_x_l_m/_a_w._d_a_t when the vendor mode is specified as aaaawwww.
  645.  
  646.      This license file will be the only FLEXlm license recognized by License
  647.      Manager or by any licensed application from Silicon Graphics or Alias |
  648.      Wavefront.
  649.  
  650.      XXXXLLLLVVVV licenses may need to be be placed in /_e_t_c/_f_l_e_x_l_m/_l_i_c_e_n_s_e._d_a_t.
  651.  
  652.  
  653.  
  654.  
  655.  
  656.  
  657.                                                                        PPPPaaaaggggeeee 11110000
  658.  
  659.  
  660.  
  661.  
  662.  
  663.  
  664. LLLLiiiicccceeeennnnsssseeeeMMMMaaaannnnaaaaggggeeeerrrr((((1111MMMM))))                                          LLLLiiiicccceeeennnnsssseeeeMMMMaaaannnnaaaaggggeeeerrrr((((1111MMMM))))
  665.  
  666.  
  667.  
  668. LLLLIIIICCCCEEEENNNNSSSSEEEE RRRREEEEPPPPLLLLAAAACCCCEEEEMMMMEEEENNNNTTTT PPPPOOOOLLLLIIIICCCCYYYY
  669.      When a new FLEXlm license is installed into a file which already has a
  670.      license with the same feature name, a lower or equal version number, and
  671.      a lower or equal count, the old license is automatically deleted.  If the
  672.      new license does not have either a higher version number, a higher count,
  673.      and a later expiration date, the new license is not installed. For the
  674.      other cases, the user is prompted on whether to replace the older license
  675.      with the newer one.
  676.  
  677.      This replacement policy can be overriden by either using one of the
  678.      license installation replacement policies: nnnnoooorrrreeeeppppllllaaaacccceeee and ssssttttrrrriiiiccccttttrrrreeeeppppllllaaaacccceeee.
  679.      Installing a license nnnnoooorrrreeeeppppllllaaaacccceeee will always add a license without removing
  680.      any installed ones. Installing a license ssssttttrrrriiiiccccttttrrrreeeeppppllllaaaacccceeee will be identical
  681.      to installing a license under the normal replacement policy if the
  682.      feature name and version number of the new license match. Otherwise it
  683.      will behave just like the nnnnoooorrrreeeeppppllllaaaacccceeee policy.
  684.  
  685.      The replacement policy is controlled using the license installation file
  686.      CCCCoooonnnnttttrrrroooollll directive as documented above, or by using the MMMMiiiisssscccceeeellllllllaaaannnneeeeoooouuuussss
  687.      field in the License Entry Dialogs.  Licenses with the optional aaaarrrrgggguuuummmmeeeennnntttt
  688.      ddddiiiisssstttt____iiiinnnnffffoooo====nnnnoooorrrreeeeppppllllaaaacccceeee will be installed using nnnnoooorrrreeeeppppllllaaaacccceeee replacement policy.
  689.      Licenses with the optional argument ssssttttrrrriiiiccccttttrrrreeeeppppllllaaaacccceeee will be installed using
  690.      ssssttttrrrriiiiccccttttrrrreeeeppppllllaaaacccceeee replacement policy.
  691.  
  692.  
  693. SSSSEEEEEEEE AAAALLLLSSSSOOOO
  694.      ls_admin(1M), license.dat(5), lmcksum(1), lmdown(1), lmhostid(1),
  695.      lmremove(1), lmreread(1), lmstat(1), lmutil(1), lmver(1), lmgrd(1),
  696.      sysinfo(1), _F_L_E_X_l_m _E_n_d _U_s_e_r _M_a_n_u_a_l.
  697.  
  698.  
  699.  
  700.  
  701.  
  702.  
  703.  
  704.  
  705.  
  706.  
  707.  
  708.  
  709.  
  710.  
  711.  
  712.  
  713.  
  714.  
  715.  
  716.  
  717.  
  718.  
  719.  
  720.  
  721.  
  722.  
  723.                                                                        PPPPaaaaggggeeee 11111111
  724.  
  725.  
  726.  
  727.